6.1.3 创建OTC代付订单

#简要描述：通过 OTC 实现法币提款

请求方式: POST
请求接口: https://网关域名/wallet-trade-merchant/v1/otc/payment/create
请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	平台分配商户 key
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户 ID	商户平台本地用户 ID
notifyUrl	string	否	回调地址	下单处理成功后，由 API 回调通知商户的地址（回调详情说明在最下方）
currency	string	是	提款币种	默认 CNY
amount	number	是	提款金额	可自定义定额（不能享受渠道费折扣，默认此订单交易速度为 NOW）或者通过文档 6.1.2 接口获取下单金额（此金额可享受渠道费折扣）
method	string	是	收款方式	ALIPAY（支付宝）、UNIONPAY（银联卡）、WECHAT（微信）、DIGITAL_RMB（数字人民币）
paymentData	object	是	收款信息	可看下方请求样例
└payee	string	是	收款人姓名
└accountId ｜ └cardNo └bankName ｜ └walletCode	string	是	收款账号
speed	string	是	交易速度	可通过文档 6.1.1 接口获取(如果为 NOW 的话，代表此订单不会进入匹配池，会被运营直接手动处理)
sign	string	是	签名	详情见签名算法

请求 json 样例

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "899952123",
  "localUserId": "4114",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo1/notify/test",
  "currency": "CNY",
  "amount": 100,
  "method": "WECHAT",
  "paymentData": {
    // ALIPAY（支付宝）
    // "payee":"柯南",
    // "accountId":18888888

    //WECHAT（微信）
    "payee": "柯南",
    "accountId": 18888888

    //UNIONPAY（大陆银联卡）
    // "payee":"柯南",
    // "cardNo":18888888
    // "bankName":"中国银行"

    // DIGITAL_RMB（数字人民币）
    // "payee":"柯南",
    // "walletCode":18888888
  },
  "speed": "FAST",
  "sign": "c6e3c292bb8cafaea50d4001185e6112"
}

响应示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
  。        "orderId": 415236189438341,
            "localOrderId": "899952123"
           }
}

响应 data 参数说明

参数名称	类型	参数含义	备注
orderId	Long	订单号
localOrderId	string	商户平台自定义订单号

回调详情说明

回调的方式是：POST application/json

回调参数 json 示例

{
  "amount": "100",
  "currency": "CNY",
  "localOrderId": "8999521232121336",
  "merchantId": 302992856974,
  "merchantUserId": "4114",
  "notifyTime": 1766134282162,
  "orderCreateTime": 1766133956739,
  "orderId": "423044353278405",
  "status": "SUCCESS",
  "sign": "563eabc8cff14e401d426ff385b643ba",
  "key": "9yUreYgTRtit39Dy"
}

参数名称	类型	参与签名	参数含义	参数说明
amount	decimal	是	订单金额
currency	String	是	币种
localOrderId	String	是	本地订单号
merchantId	Long	是	商户号
merchantUserId	String	是	商户的用户 ID
notifyTime	long	是	回调时间
orderCreateTime	Long	是	订单创建时间
orderId	String	是	订单号
status	String	是	代付状态	SUCCESS:已完成 \| FAIL:已失败
sign	String	否	md5 签名	详情请看签名算法
key	String	是	api key

如果您接受到了回调信息，只需要返回success，即表示消息已处理，本条回调不再会发送，否则会尝试重复发送直到获得期望的响应，目前的重试频率为15s, 15s, 30s, 180s, 600s, 1200s, 1800s，都无响应后，不再重复发送。

请求参数​

响应 data 参数说明​

回调详情说明​

回调的方式是：POST application/json​

请求参数

响应 data 参数说明

回调详情说明

回调的方式是：POST application/json